Command line Interface
 ImageView Help Index

Commands

File menu

Edit menu

View menu

Window menu

Help menu

Toolbar

Command-line Interface


File menu commands

The File menu offers the following commands:

Open	Opens an image file.
Close	Closes the active window.
Print	Prints a document.
Exit	Exits ImageView.


Edit menu commands

The Edit menu offers the following commands:

Copy	Copies data from the document to the clipboard.


View menu commands

The View menu offers the following commands:

Rotate	Rotates the image 90 degrees clockwise.
Zoom In	Zoom in on the image (magnify the image).
Zoom Out	Zoom out on the image (reduce the size of the image).
Scale	Increase or decrease the size of the image.
Increase Contrast	Increase the contrast of the image. This command is not available for Photo CD images.
Decrease Contrast	Decrease the contrast of the image. This command is not available for Photo CD images.
Toolbar	Shows or hides the toolbar.
StatusBar	Shows or hides the status bar.


Window menu commands

The Window menu offers the following commands, which enable you to arrange multiple views of multiple documents in the application window:

Cascade	Arranges windows in an overlapped fashion.
Tile	Arranges windows in non-overlapped tiles.
Arrange Icons	Arranges icons of closed windows.
Window 1, 2, ...	Goes to specified window.


Help menu commands

The Help menu offers the following commands, which provide you assistance with this application:

Index	Offers you an index to topics on which you can get help.
Using Help	Provides general instructions on using help.
About	Displays the version number of this application.


File Open command
Open command (File menu)

Use this command to open an image in a new window.  You can have multiple image windows open at once.  Use the Window menu to switch among the multiple open documents.  See Window 1, 2, ... command.

Shortcuts

Keys:	CTRL+O


File Open dialog box

The following options allow you to specify which file to open:

File Name

Type or select the filename you want to open.  This box lists files with the extension you select in the List Files of Type box.

List Files of Type

Select the type of file you want to open:

PCX file (.PCX)

Windows bitmap file (.BMP)

GIF file (.GIF)

JPEG file (.JPG)

Targa file (.TGA)

Photo CD file (.PCD)

Drives

Select the drive containing the file that you want to open.

Directories

Select the directory containing the file that you want to open.


File Close command
Close command (File menu)

Use this command to close the active image window.

You can also close a window by using the Close icon on the window frame, as shown below:


File Exit command
Exit command (File menu)

Use this command to end your ImageView session.  You can also use the Close command on the application Control menu.

Shortcuts

Mouse:	Double-click the application's Control menu button.

Keys:	ALT+F4


Copy command (Edit menu)

Use this command to copy a selected area of the image to the clipboard.  This command is unavailable if there is no image area selected. You select an area of the image by dragging with the right mouse button pressed.

Copying data to the clipboard replaces the contents previously stored there.

Shortcuts

Keys:	CTRL+C


View Toolbar command
Toolbar command (View menu)

Use this command to display and hide the Toolbar, which includes buttons for some of the most common commands in ImageView.  A check mark appears next to the menu item when the Toolbar is displayed.

See Toolbar for help on using the toolbar.


Toolbar

The toolbar is displayed across the top of the application window, below the menu bar.  The toolbar provides quick mouse access to many tools used in ImageView,

To hide or display the Toolbar, choose Toolbar from the View menu (ALT, V, T).

Click	To

Print the image. The image will be printed at about the same size that it appears on the screen.

Rotate the image 90 degrees clockwise.

Zoom in on the image. You can also zoom the image by drawing a box around the area to be zoomed with the left mouse button.

 Zoom out on the image.

 Increase the image contrast. This is not available for Photo CD images.

 Decrease the image contrast. This is not available for Photo CD images. It is also not available until you have increased the contrast at least once.


View Status Bar Command
Status Bar command (View menu)

Use this command to display and hide the Status Bar, which describes the action to be executed by the selected menu item or depressed toolbar button, and keyboard latch state. A check mark appears next to the menu item when the Status Bar is displayed.

See Status Bar for help on using the status bar.


Status Bar

The status bar is displayed at the bottom of the ImageView window.  To display or hide the status bar, use the Status Bar command in the View menu.

The left area of the status bar describes actions of menu items as you use the arrow keys to navigate through menus.  This area similarly shows messages that describe the actions of toolbar buttons as you depress them, before releasing them.  If after viewing the description of the toolbar button command you wish not to execute the command, then release the mouse button while the pointer is off the toolbar button.

The right areas of the status bar indicate which of the following keys are latched down:

Indicator	Description

CAP	The Caps Lock key is latched down.

NUM	The Num Lock key is latched down.

SCRL	The Scroll Lock key is latched down.


Cascade command (Window menu)

Use this command to arrange multiple opened windows in an overlapped fashion.


Tile command (Window menu)

Use this command to arrange multiple opened windows in a non-overlapped fashion.


Tile Horizontal command (Window menu)

Use this command to vertically arrange multiple opened windows in a non-overlapped fashion.


Tile Vertical command (Window menu)

Use this command to arrange multiple opened windows side by side.


Window Arrange Icons Command

Use this command to arrange the icons for minimized windows at the bottom of the main window.  If there is an open document window at the bottom of the main window, then some or all of the icons may not be visible because they will be underneath this document window.


1, 2, ... command (Window menu)

ImageView displays a list of currently open image windows at the bottom of the Window menu.  A check mark appears in front of the name of the active window.  Choose a window from this list to make it active.


Index command (Help menu)

Use this command to display the opening screen of Help.  From the opening screen, you can jump to step-by-step instructions for using ImageView and various types of reference information.

Once you open Help, you can click the Contents button whenever you want to return to the opening screen.


Using Help command (Help menu)

Use this command for instructions about using Help.


About command (Help menu)

Use this command to display the copyright notice and version number of your copy of ImageView.


Title Bar

ImageView

The title bar is located along the top of a window.  It contains the name of the application and document.

To move the window, drag the title bar.  Note: You can also move dialog boxes by dragging their title bars.

A title bar may contain the following elements:

Application Control-menu button

Document Control-menu button

Maximize button

Minimize button

Name of the application

Name of the document

Restore button


Scroll bars

Displayed at the right and bottom edges of the document window.  The scroll boxes inside the scroll bars indicate your vertical and horizontal location in the image.  You can use the mouse to scroll to other parts of the image.


Size command (System menu)

Use this command to display a four-headed arrow so you can size the active window with the arrow keys.

After the pointer changes to the four-headed arrow:

1.	Press one of the DIRECTION keys (left, right, up, or down arrow key) to move the pointer to the border you want to move.

2.	Press a DIRECTION key to move the border.

3.	Press ENTER when the window is the size you want.

Note:  This command is unavailable if you maximize the window.

Shortcut

Mouse:	Drag the size bars at the corners or edges of the window.


Move command (Control menu)

Use this command to display a four-headed arrow so you can move the active window or dialog box with the arrow keys.

Note:  This command is unavailable if you maximize the window.

Shortcut

Keys:	CTRL+F7


System Minimize Command
Minimize command (application Control menu)

Use this command to reduce the ImageView window to an icon.

Shortcut

Mouse:	Click the minimize icon [image] on the title bar.

Keys:	ALT+F9


Maximize command (System menu)

Use this command to enlarge the active window to fill the available space.

Shortcut

Mouse:	Click the maximize icon [image] on the title bar; or double-click the title bar.

Keys:	CTRL+F10 enlarges a document window.


Next Window command (document Control menu)

Use this command to switch to the next open image window.  ImageView determines which window is next according to the order in which you opened the windows.

Shortcut

Keys:	CTRL+F6


Previous Window command (document Control menu)

Use this command to switch to the previous open image window.  ImageView determines which window is previous according to the order in which you opened the windows.

Shortcut

Keys:	SHIFT+CTRL+F6


Close command (Control menus)

Use this command to close the active window or dialog box.

Double-clicking a Control-menu box is the same as choosing the Close command.

Note: You can close all windows at once with the Close command on the File menu.

Shortcuts

Keys: 	CTRL+F4 closes a document window

ALT+F4 closes the <<YourType>> window or dialog box


Restore command (Control menu)

Use this command to return the active window to its size and position before you chose the Maximize or Minimize command.


Switch to command (application Control menu)

Use this command to display a list of all open applications.  Use this "Task List" to switch to or close an application on the list.

Shortcut

Keys:	CTRL+ESC

Dialog Box Options

When you choose the Switch To command, you will be presented with a dialog box with the following options:

Task List

Select the application you want to switch to or close.

Switch To

Makes the selected application active.

End Task

Closes the selected application.

Cancel

Closes the Task List box.

Cascade

Arranges open applications so they overlap and you can see each title bar.  This option does not affect applications reduced to icons.

Tile

Arranges open applications into windows that do not overlap.  This option does not affect applications reduced to icons.

Arrange Icons

Arranges the icons of all minimized applications across the bottom of the screen.


Scale Command (View menu)

Best Fit	Scales the image to fit in the window such that the entire image is visible.
Fit Horizontal	Scales the image so it fills the window horizontally.
Fit Vertical	Scales the image so it fills the window vertically.
Full Size	Scales the image so that each pixel of the original images is mapped to one pixel on the screen.
Note: The Scale commands are not available for Photo CD images, since these images are only available at fixed sizes. Use the Zoom Out and Zoom In commands to change the size of Photo CD images.


Command-line Interface

ImageView can be launched from another application using the Windows WinExec API function (or its equivalent in applications having a macro facility).

Only one instance of ImageView can be running at any time. You can send commands to ImageView at the time you launch it or after it is running. You always specify ImageView.exe as the first argument to the WinExec function. You can add these command-line arguments:

Open Image File (-f)

Rotate Image (-r)

Move Window (-m)

Minimize Window (-i)

Maximize Window (-x)

Restore Window (-n)

Set Contrast (-c)

Scale Image (-s)

Kill Application (-k)

Note: You cannot send commands to an ImageView application that has been launched manually. When you launch ImageView from another application, you must specify at least the -f command, even if it contains no filename in order for ImageView to run in server mode.


Open Image File (-f)

Opens the specified image file. For example:

-fimage1.tif


Rotate Image (-r)

Rotates the image the specified number of degrees. The only valid values are:

-r0

-r90

-r180

-r270

The image is rotated the specified number of degrees from its original orientation (not from the current orientation).


Move Image (-m)

The ImageView application window is moved to the specified position on the screen. Coordinates are based on 0,0 as the upper left corner of the screen. Units are in pixels.

-m10,20	Moves the ImageView application window to pixel location 10,20.
-m10,20,200,100	Move the ImageView window to pixel location 10,20 and changes its with and height to 200 and 100.


Minimize Window (-i)

Changes the ImageView application window to an icon.


Maximize Window (-x)

Maximizes the ImageView application window.


Restore Window (-n)

Restores the ImageView application window to its normal size.


Change Contrast (-c)

-c+	Increases the image contrast.
-c-	Decreases the image contrast.

Note: Contrast adjustment is not available for Photo CD images, in which case this command is ignored by ImageView.


Scale Image (-s)

-sB	Best Fit
-sV	Fit Vertical
-sH	Fit Horizontal
-sF	Full Size
-sP<percent>	Percentage (for example, -sP12.5)
-s+	Zoom In
-s-	Zoom Out

Note: Only s+ and s- commands are available for Photo CD images. For these images, all other scaling commands are ignored.


Kill Application (-k)

Terminates the ImageView application.


File Print command
Print command (File menu)

Use this command to print a document.   This command presents a Print dialog box, where you may specify the range of pages to be printed, the number of copies, the destination printer, and other printer setup options.

Shortcuts

Toolbar:

Keys:	CTRL+P


Print dialog box

The following options allow you to specify how the document should be printed:

Printer

This is the active printer and printer connection.  Choose the Setup option to change the printer and printer connection.

Setup

Displays a Print Setup dialog box, so  you can select a printer and printer connection.

Print Range

Specify the pages you want to print:

All	Prints the entire document.
Selection	Prints the currently selected text.
Pages	Prints the range of pages you specify in the From and To boxes.
Copies

Specify the number of copies you want to print for the above page range.

Collate Copies

Prints copies in page number order, instead of separated multiple copies of each page.

Print Quality

Select the quality of the printing.  Generally, lower quality printing takes less time to produce.


Print Progress Dialog

The Printing dialog box is shown during the time that <<YourApp>> is sending output to the printer.  The page number indicates the progress of the printing.

To abort printing, choose Cancel.


File Print Preview command
Print Preview command (File menu)

Use this command to display the active document as it would appear when printed.  When you choose this command, the main window will be replaced with a print preview window in which one or two pages will be displayed in their printed format.  The print preview toolbar offers you options to view either one or two pages at a time; move back and forth through the document; zoom in and out of pages; and initiate a print job.


Print Preview toolbar

The print preview toolbar offers you the following options:

Print

Bring up the print dialog box, to start a print job.

Next Page

Preview the next printed page.

Prev Page

Preview the previous printed page.

One Page / Two Page

Preview one or two printed pages at a time.

Zoom In

Take a closer look at the printed page.

Zoom Out

Take a larger look at the printed page.

Close

Return from print preview to the editing window.


File Print Setup command
Print Setup command (File menu)

Use this command to select a printer and a printer connection.  This command presents a Print Setup dialog box, where you specify the printer and its connection.


Print Setup dialog box

The following options allow you to select the destination printer and its connection.

Printer

Select the printer you want to use.  Choose the Default Printer; or choose the Specific Printer option and select one of the current installed printers shown in the box.  You install printers and configure ports using the Windows Control Panel.

Orientation

Choose Portrait or Landscape.

Paper Size

Select the size of paper that the document is to be printed on.

Paper Source

Some printers offer multiple trays for different paper sources.  Specify the tray here.

Options

Displays a dialog box where you can make additional choices about printing, specific to the type of printer you have selected.

Network...

Choose this button to connect to a network location, assigning it a new drive letter.


File Page Setup Command
Page Setup command (File menu)

<< Write application-specific help here. >>